home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / catclock / README < prev    next >
Encoding:
Text File  |  1995-05-03  |  3.0 KB  |  86 lines
  1.  
  2.                 XCLOCK NOTES
  3.                 ------------
  4.  
  5. Description
  6. -----------
  7.  
  8.     This version of xclock is a Motif-based variant of the MIT xclock 
  9. program,  with an alarm feature, and a new "cat" mode, in addition to
  10. the analog and digital modes.
  11.  
  12. History 
  13. --------
  14.  
  15.     The code here started out as an X10 client program back in 1984.  Xclock 
  16. was originally written by Tony Della Fera of DEC, and "Hacked up by a cast of 
  17. thousands . . .".  The alarm feature was added sometime later by
  18. Ed Moy of Berkeley.  For X11, xclock was turned into an Xaw application
  19. by transferring most of the functionality to an xclock widget.  The
  20. alarm feature never made it back into the MIT sources.
  21.  
  22.     The current incarnation of xclock is now a Motif 1.1.1 application, and
  23. has the new "cat" mode.  The cat image was based on the famous "Kit-Cat" (R)
  24. plastic wall clock, and was designed by Deanna Hohn of DEC Advanced Technology
  25. Development.  The Motif interface, eyes, tails, and the general state
  26. of the program now are a product of Philip Schneider of DEC.
  27.  
  28.     Only God and a large number of lawyers could ever determine exactly
  29. who owns this code, what the copying restrictions might be, etc.  You're
  30. probably OK as long as the original copyright header remains intact, and
  31. you don't try to sell it or use it in any sort of a product.  The original
  32. code came from MIT, and so I expect that their ownership/copying restrictions
  33. apply.  Changes done by Deanna Hohn and Philip Schneider are free of
  34. any restrictions beyond those which may hold for the original sources.
  35.  
  36.  
  37. Compiling
  38. ---------
  39.  
  40.     On most systems,  just typing in the following should do what you want:
  41.  
  42.     xmkmf <top-level X directory> .
  43.     make depend
  44.     make
  45.  
  46.     A non-imake Makefile exists for those who might want/need it, called
  47.     Makefile.simple.
  48.  
  49.     You may need/want to change the following things in the IMakefile :
  50.  
  51.     MOTIFLIBS    --    locations of libXm.a and libXt.a
  52.     MOTIFINCS    --    include file directories
  53.     DESTINATION    --    where to install xclock
  54.         DEFINES         --    define HAS_GNU_EMACS if you use
  55.                 GNU emacs; comment-out if you use
  56.                 an emacs that must be executed in
  57.                 an xterm window.
  58.  
  59.     This program has been tested only on DEC Ultrix workstations.  It
  60. *should* be portable to any X/Unix/Motif-"compliant" system.  There
  61. may be some os-dependent stuff in the parts of the code that allow
  62. you to call up your editor on the alarm file, but this should be
  63. easily removable or fixable if need be.  
  64.  
  65.  
  66. Application Defaults / Command-line Options
  67. -------------------------------------------
  68.  
  69.     Xclock (should :-) correctly parse all Xt arguments, and all the usual
  70. Xt resources (e.g., in one's .Xdefaults file) apply to xclock. (These are
  71. things like -display, -geometry, -reverse, etc.)  In addition, there are a 
  72. number of xclock-specific options, which are detailed in the man page
  73. "xclock.man".  A sample set of entries for one's ".Xdefaults" file are located
  74. in the file "xclock.ad".
  75.  
  76.  
  77. Bug Reports
  78. -----------
  79.  
  80.     Please send bug reports, comments, etc. to :
  81.  
  82.     Philip Schneider
  83.     pjs@pa.dec.com
  84.  
  85.  
  86.